cisco-cvp-ux
Create PaymentMethod TMF670 POST
[POST] Towards ARIA and Salesforce
This operation create a paymentMethod entity for customer.
Request
URL
http://[host]:[port]/cisco-cvp-ux/v1/{businessId}/paymentMethod
Common Parameters
Base URI parameters and headers are common to all the resources as part of payment-methods Biz API, listed below with details.
Base URI Parameter
Name | Type | M/O | Description |
---|---|---|---|
businessId | string | M | Business unit identifier. Example: PR |
Query Parameter
Name | Type | M/O | Description |
---|---|---|---|
MSISDN | string | O | Phone Number of the customer. Example: 17879697922 |
Headers
Name | Type | M/O | Description |
---|---|---|---|
X-Correlation-ID | string | M | This is a unique identifier for the current call chain that can be used to tie together log entries on multiple layers. Example: 644e1dd7-2a7f-18fb-b8ed-ed78c3F92c2b |
lob | string | M | The Line of Business Identifier currently available are: FIXED, POSTPAID or PREPAID |
channelId | string | O | Channel to identify the business group. Ex: ivrB2C |
Security Headers
Name | Type | M/O | Description |
---|---|---|---|
client_id | string | M | Client Id value for Client Id Enforcement policy. Environment Specific Value. Eg: 6f0ed16a7b494d76b2d60e05bc3b3332 |
client_secret | string | M | Client secret value for Client Id Enforcement policy. Environment Specific Value, eg: e4CD4D43449846aA9D8Cb9c43fAd324a |
Body
Request Body for Aria
{
"id": "PAYMENT_99905",
"name": "Main credit card",
"authorizationCode": "AutoPay_Due_15_PR",
"description": "IVR One Time Payment",
"@type": "TokenizedCreditCard",
"account": [
{
"id": "ARIATESTING013"
}
],
"details": {
"token": "gftvcdb"
}
}
Request Body for Salesforce
{
"token": "cGF5bWVudG1ldGhvZF9jY181a25obmtzZg",
"account": [
{
"id": "31516278-31514752",
"@type": "BillingAccount",
"relatedParty": [
{
"id": "12401231232",
"@type": "msisdn"
}
]
}
],
"relatedParty": [
{
"name": "BrainTreeToken",
"@type": "paymentGatewayType"
},
{
"@type": "channel",
"name": "IVR"
}
]
}
Response
Possible response success
This section defines all the possible data structures received by the client and that must be considered satisfactory at the time of responding to the method.
TMF Response for post payment method
Success Response from Aria
{
"relatedParty": [
{
"id": "39167180",
"@type": "BillcontactRef"
}
],
"id": "PAYMENT_99905",
"name": "Main credit card",
"authorizationCode": "AutoPay_Due_15_PR",
"description": "IVR One Time Payment",
"@type": "TokenizedCreditCard",
"account": [
{
"id": "ARIATESTING013"
}
],
"details": {
"token": "gftvcdb"
},
"contact": [
{
"contactName": "Rohit,G,Jose",
"contactType": "primary",
"contactMedium": [
{
"mediumType": "PostalAddress",
"characteristic": {
"city": "Toronto",
"street1": "15 Rue des Canards",
"street2": "15 Rue des Canards",
"postCode": "75014",
"country": "CA",
"stateOrProvince": "AB",
"phoneNumber": "9123746584",
"emailAddress": "Annacristal@gmail.com",
"faxNumber": "3454354353"
}
}
]
}
]
}
Success Response from Salesforce
{
"description": "payment method create request received"
}
Definitions
name | type | description | required |
---|---|---|---|
id | string | Unique Identifier within the server for the payment method. | Y |
authorizationCode | string | Authorization code retrieved from an external payment gateway that could be used for conciliation | Y |
description | string | Text describing the contents of the payment | N |
name | string | Screen name of the payment | N |
account | object | Reference to the accounts that are linked to the payment method.. A account may be a party account or a financial account. | Y |
account.id | string | Unique identifier of the account | Y |
account.name | string | Name of the account | N |
@type | string | Type of payment method | Y |
relatedParty | array | Information about an associated entity and its role. Account that owns the payment method | N |
relatedParty.id | string | Unique identifier of the related party | N |
relatedParty.@type | string | Type of party | N |
status | string | status of the payment | N |
details | object | Details of the payment method. This object's type depends on the value of the type field | N |
details.token | string | token details of a tokenized bank card | Y |
contact | object Array | An individual or an organization used as a contact point for a given account and accessed via some contact medium. | N |
contact.contactName | string | A displayable name for that contact | N |
contact.contactType | string | Type of contact (primary, secondary...) | N |
contact.partyRoleType | string | Identifies what kind of party role type is linked to the contact (a account manager...) | N |
contact.contactMedium | object Array | Indicates the contact medium that could be used to contact the party. | N |
contact.contactMedium.mediumType | string | Type of the contact medium, such as: email address, telephone number, postal address | N |
contact.contactMedium.preferred | boolean | If true, indicates that is the preferred contact medium | N |
contact.contactMedium.characteristic | object | Any additional characteristic(s) of this contact medium | N |
contact.contactMedium.characteristic.city | string | City | N |
contact.contactMedium.characteristic.contactType | string | The type of contact, for example; phone number such as mobile, fixed home, fixed office. postal address such as shipping installation | N |
contact.contactMedium.characteristic.country | string | N | |
contact.contactMedium.characteristic.emailAddress | string | Full email address in standard format | N |
contact.contactMedium.characteristic.faxNumber | string | The fax number of the contact | N |
contact.contactMedium.characteristic.phoneNumber | string | The primary phone number of the contact | N |
contact.contactMedium.characteristic.postCode | string | Postcode | N |
contact.contactMedium.characteristic.socialNetworkId | string | Identifier as a member of a social network | N |
contact.contactMedium.characteristic.stateOrProvince | string | State or province | N |
contact.contactMedium.characteristic.street1 | string | Describes the street | N |
contact.contactMedium.characteristic.street2 | string | Complementary street description | N |
contact.contactMedium.characteristic..@baseType | string | When sub-classing, this defines the super-class | N |
contact.contactMedium.characteristic..@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
contact.contactMedium.characteristic..@type | string | When sub-classing, this defines the sub-class entity name | N |
contact.contactMedium.validFor | accountRelationship.validFor | N | |
contact.contactMedium.@baseType | string | When sub-classing, this defines the super-class | N |
contact.contactMedium.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
contact.contactMedium.@type | string | When sub-classing, this defines the sub-class entity name | N |
contact.relatedParty | relatedParty | N | |
contact.validFor | accountRelationship.validFor | N | |
contact.@baseType | string | When sub-classing, this defines the super-class | N |
contact.@schemaLocation | string | A URI to a JSON-Schema file that defines additional attributes and relationships | N |
contact.@type | string | When sub-classing, this defines the sub-class entity name | N |